home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1998 January: Mac OS SDK / Dev.CD Jan 98 SDK1.toast / Development Kits (Disc 1) / Interfaces&Libraries / Universal / Interfaces / AIncludes / QD3DIO.a < prev    next >
Encoding:
Text File  |  1997-08-12  |  30.5 KB  |  1,121 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        QD3DIO.a
  3. ;
  4. ;    Contains:    QuickDraw 3D IO API                                                
  5. ;
  6. ;    Version:    Technology:    Quickdraw 3D 1.5.1
  7. ;                Release:    Universal Interfaces 3.0.1
  8. ;
  9. ;    Copyright:    © 1995-1997 by Apple Computer, Inc., all rights reserved.
  10. ;
  11. ;    Bugs?:        Please include the the file and version information (from above) with
  12. ;                the problem description.  Developers belonging to one of the Apple
  13. ;                developer programs can submit bug reports to:
  14. ;
  15. ;                    devsupport@apple.com
  16. ;
  17. ;
  18.     IF &TYPE('__QD3DIO__') = 'UNDEFINED' THEN
  19. __QD3DIO__ SET 1
  20.  
  21.     IF &TYPE('__QD3D__') = 'UNDEFINED' THEN
  22.     include 'QD3D.a'
  23.     ENDIF
  24.  
  25.     IF &TYPE('__QD3DDRAWCONTEXT__') = 'UNDEFINED' THEN
  26.     include 'QD3DDrawContext.a'
  27.     ENDIF
  28.     IF &TYPE('__QD3DVIEW__') = 'UNDEFINED' THEN
  29.     include 'QD3DView.a'
  30.     ENDIF
  31.  
  32. ; ******************************************************************************
  33. ; **                                                                              **
  34. ; **                                    Basic Types                                 **                                                    
  35. ; **                                                                              **
  36. ; ****************************************************************************
  37.  
  38. ; typedef unsigned char                 TQ3Uns8
  39.  
  40. ; typedef signed char                     TQ3Int8
  41.  
  42. ; typedef unsigned short                 TQ3Uns16
  43.  
  44. ; typedef signed short                     TQ3Int16
  45.  
  46. ; typedef unsigned long                 TQ3Uns32
  47.  
  48. ; typedef signed long                     TQ3Int32
  49.  
  50.     IF TARGET_OS_MAC THEN
  51. TQ3Uns64                RECORD 0
  52. hi                         ds.l    1                ; offset: $0 (0)
  53. lo                         ds.l    1                ; offset: $4 (4)
  54. sizeof                     EQU *                    ; size:   $8 (8)
  55.                         ENDR
  56. TQ3Int64                RECORD 0
  57. hi                         ds.l    1                ; offset: $0 (0)
  58. lo                         ds.l    1                ; offset: $4 (4)
  59. sizeof                     EQU *                    ; size:   $8 (8)
  60.                         ENDR
  61.     ELSE
  62. TQ3Uns64                RECORD 0
  63. lo                         ds.l    1                ; offset: $0 (0)
  64. hi                         ds.l    1                ; offset: $4 (4)
  65. sizeof                     EQU *                    ; size:   $8 (8)
  66.                         ENDR
  67. TQ3Int64                RECORD 0
  68. lo                         ds.l    1                ; offset: $0 (0)
  69. hi                         ds.l    1                ; offset: $4 (4)
  70. sizeof                     EQU *                    ; size:   $8 (8)
  71.                         ENDR
  72.     ENDIF    ; TARGET_OS_MAC
  73. ; typedef float                         TQ3Float32
  74.  
  75. ; typedef double                         TQ3Float64
  76.  
  77. ; typedef TQ3Uns32                         TQ3Size
  78.  
  79. ; ******************************************************************************
  80. ; **                                                                              **
  81. ; **                                    File Types                                 **
  82. ; **                                                                              **
  83. ; ****************************************************************************
  84.  
  85.  
  86. ; typedef long                            TQ3FileModeMasks
  87. kQ3FileModeNormal                EQU        0
  88. kQ3FileModeStream                EQU        $01
  89. kQ3FileModeDatabase                EQU        $02
  90. kQ3FileModeText                    EQU        $04
  91. ; typedef unsigned long                 TQ3FileMode
  92.  
  93. ; ******************************************************************************
  94. ; **                                                                              **
  95. ; **                                    Method Types                             **
  96. ; **                                                                              **
  97. ; ****************************************************************************
  98.  
  99. ; 
  100. ; *    IO Methods
  101. ; *
  102. ; *    The IO system treats all objects as groups of typed information.
  103. ; *    When you register your element or attribute, the "elementType" is the 
  104. ; *    binary type of your object, the "elementName" the ascii type.
  105. ; *    
  106. ; *    All objects in the metafile are made up of a "root" or parent object which
  107. ; *    defines the instantiated object type. You may define the format of your 
  108. ; *    data any way you wish as long as you use the primitives types above and the
  109. ; *    routines below.
  110. ; *
  111. ; *    Root Objects are often appended with additional child objects, called 
  112. ; *    subobjects. You may append your object with other QuickDraw 3D objects.
  113. ; *    
  114. ; *    Writing is straightforward: an object traverses itself any other objects 
  115. ; *    that make it up, then writes its own data. Writing uses two methods: 
  116. ; *    TQ3ObjectTraverseMethod and TQ3ObjectWriteMethod.
  117. ; *
  118. ; *    The TQ3ObjectTraverseMethod method should:
  119. ; *    + First, Determine if the data should be written 
  120. ; *        - if you don't want to write out your object after examining your
  121. ; *            data, return kQ3Success in your Traverse method without calling
  122. ; *            any other submit calls.
  123. ; *     + Next, calculate the size of your object on disk
  124. ; *     + Gather whatever state from the view you need to preserve
  125. ; *         - you may access the view state NOW, as the state of the
  126. ; *             view duing your TQ3ObjectWriteMethod will not be valid. You may
  127. ; *             pass a temporary buffer to your write method.
  128. ; *     + Submit your view write data using Q3View_SubmitWriteData
  129. ; *         - note that you MUST call this before any other "_Submit" call.
  130. ; *         - you may pass in a "deleteMethod" for your data. This method
  131. ; *             will be called whether or not your write method succeeds or fails.
  132. ; *     + Submit your subobjects to the view
  133. ; *     
  134. ; *     The TQ3ObjectWriteMethod method should:
  135. ; *     + Write your data format to the file using the primitives routines below.
  136. ; *         - If you passed a "deleteMethod" in your Q3View_SubmitWriteData, that
  137. ; *             method will be called upon exit of your write method.
  138. ; *
  139. ; *    Reading is less straightforward because your root object and
  140. ; *    any subobjects must be read inside of your TQ3ObjectReadDataMethod. There 
  141. ; *    is an implicit state contained in the file while reading, which you must 
  142. ; *    be aware of. When you first enter the read method, you must physically 
  143. ; *    read in your data format using the primitives routines until
  144. ; *    
  145. ; *    Q3File_IsEndOfData(file) == kQ3True
  146. ; *    
  147. ; *    Generally, your data format should be self-descriptive such that you do not
  148. ; *    need to call Q3File_IsEndOfData to determine if you are done reading. 
  149. ; *    However, this call is useful for determining zero-sized object or 
  150. ; *    determining the end of an object's data.
  151. ; *    
  152. ; *    Once you have read in all the data, you may collect subobjects. A metafile
  153. ; *    object ONLY has subobjects if it is in a container. The call
  154. ; *    
  155. ; *    Q3File_IsEndOfContainer(file)
  156. ; *    
  157. ; *    returns kQ3False if subobjects exist, and kQ3True if subobjects do not 
  158. ; *    exist.
  159. ; *    
  160. ; *    At this point, you may use
  161. ; *    
  162. ; *    Q3File_GetNextObjectType
  163. ; *    Q3File_IsNextObjectOfType
  164. ; *    Q3File_ReadObject
  165. ; *    Q3File_SkipObject
  166. ; *    
  167. ; *    to iterate through the subobjects until Q3File_IsEndOfContainer(file) 
  168. ; *    is kQ3True.
  169. ; * 
  170. ; 
  171.  
  172. ; 
  173. ; *    TQ3ObjectTraverseMethod
  174. ; *
  175. ; *    For "elements" (meaning "attributes, too), you will be passed NULL for 
  176. ; *    object. Sorry, custom objects will be available in the next major revision.
  177. ; *
  178. ; *    The "data" is a pointer to your internal element data.
  179. ; *
  180. ; *    The view is the current traversal view.
  181. ; 
  182.  
  183. ; 
  184. ; *  Use Q3XView_SubmitWriteData instead...
  185. ; 
  186.  
  187. ;
  188. ; extern TQ3Status Q3View_SubmitWriteData(TQ3ViewObject view, TQ3Size size, void *data, TQ3DataDeleteMethod deleteData)
  189. ;
  190.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  191.         IMPORT_CFM_FUNCTION Q3View_SubmitWriteData
  192.     ENDIF
  193.  
  194. ; 
  195. ; *    TQ3ObjectReadDataMethod
  196. ; *
  197. ; *  For "elements" (meaning "attributes", too), you must allocate stack space 
  198. ; *    and call Q3Set_Add on "parentObject", which is an TQ3SetObject.
  199. ; *
  200. ; *    Otherwise, parentObject is whatever object your element is a subobject of...
  201. ; 
  202.  
  203. ; 
  204. ; * IO Methods
  205. ; 
  206.  
  207.  
  208. kQ3XMethodTypeObjectFileVersion    EQU        'vers'                ; version 
  209. kQ3XMethodTypeObjectTraverse    EQU        'trvs'                ; byte count 
  210. kQ3XMethodTypeObjectTraverseData EQU    'trvd'                ; byte count 
  211. kQ3XMethodTypeObjectWrite        EQU        'writ'                ; Dump info to file 
  212. kQ3XMethodTypeObjectReadData    EQU        'rddt'                ; Read info from file into buffer or, attach read data to parent 
  213. kQ3XMethodTypeObjectRead        EQU        'read'
  214. kQ3XMethodTypeObjectAttach        EQU        'attc'
  215. ; 
  216. ; *    TQ3XObjectTraverseMethod
  217. ; *
  218. ; *    For "elements" (meaning "attributes, too), you will be passed NULL for 
  219. ; *    object. Sorry, custom objects will be available in the next major revision.
  220. ; *
  221. ; *    The "data" is a pointer to your internal element data.
  222. ; *
  223. ; *    The view is the current traversal view.
  224. ; 
  225.  
  226. ; 
  227. ; *  TQ3XObjectTraverseDataMethod
  228. ; 
  229.  
  230. ; 
  231. ; *  TQ3XObjectWriteMethod
  232. ; 
  233.  
  234. ; 
  235. ; *  Custom object writing 
  236. ; 
  237.  
  238. ;
  239. ; extern TQ3Status Q3XView_SubmitWriteData(TQ3ViewObject view, TQ3Size size, void *data, TQ3XDataDeleteMethod deleteData)
  240. ;
  241.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  242.         IMPORT_CFM_FUNCTION Q3XView_SubmitWriteData
  243.     ENDIF
  244.  
  245. ;
  246. ; extern TQ3Status Q3XView_SubmitSubObjectData(TQ3ViewObject view, TQ3XObjectClass objectClass, unsigned long size, void *data, TQ3XDataDeleteMethod deleteData)
  247. ;
  248.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  249.         IMPORT_CFM_FUNCTION Q3XView_SubmitSubObjectData
  250.     ENDIF
  251.  
  252. ; 
  253. ; *  TQ3XObjectReadMethod
  254. ; 
  255.  
  256. ; 
  257. ; *    TQ3XObjectReadDataMethod
  258. ; *
  259. ; *  For "elements" (meaning "attributes", too), you must allocate stack space 
  260. ; *    and call Q3Set_Add on "parentObject", which is an TQ3SetObject.
  261. ; *
  262. ; *    Otherwise, parentObject is whatever object your element is a subobject of...
  263. ; 
  264.  
  265. ; 
  266. ; *  TQ3XObjectAttachMethod
  267. ; 
  268.  
  269.  
  270.  
  271. ; ******************************************************************************
  272. ; **                                                                              **
  273. ; **                                Versioning                                     **
  274. ; **                                                                              **
  275. ; ****************************************************************************
  276.  
  277. ; typedef unsigned long                 TQ3FileVersion
  278.  
  279. ; ******************************************************************************
  280. ; **                                                                              **
  281. ; **                                String Constants                             **
  282. ; **                                                                              **
  283. ; ****************************************************************************
  284.  
  285. ; ******************************************************************************
  286. ; **                                                                              **
  287. ; **                                File Routines                                 **
  288. ; **                                                                              **
  289. ; ****************************************************************************
  290.  
  291. ; 
  292. ; * Creation and accessors
  293. ; 
  294.  
  295. ;
  296. ; extern TQ3FileObject Q3File_New(void )
  297. ;
  298.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  299.         IMPORT_CFM_FUNCTION Q3File_New
  300.     ENDIF
  301.  
  302. ;
  303. ; extern TQ3Status Q3File_GetStorage(TQ3FileObject theFile, TQ3StorageObject *storage)
  304. ;
  305.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  306.         IMPORT_CFM_FUNCTION Q3File_GetStorage
  307.     ENDIF
  308.  
  309. ;
  310. ; extern TQ3Status Q3File_SetStorage(TQ3FileObject theFile, TQ3StorageObject storage)
  311. ;
  312.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  313.         IMPORT_CFM_FUNCTION Q3File_SetStorage
  314.     ENDIF
  315.  
  316. ; 
  317. ; * Opening, and accessing "open" state, closing/cancelling
  318. ; 
  319.  
  320. ;
  321. ; extern TQ3Status Q3File_OpenRead(TQ3FileObject theFile, TQ3FileMode *mode)
  322. ;
  323.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  324.         IMPORT_CFM_FUNCTION Q3File_OpenRead
  325.     ENDIF
  326.  
  327. ;
  328. ; extern TQ3Status Q3File_OpenWrite(TQ3FileObject theFile, TQ3FileMode mode)
  329. ;
  330.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  331.         IMPORT_CFM_FUNCTION Q3File_OpenWrite
  332.     ENDIF
  333.  
  334. ;
  335. ; extern TQ3Status Q3File_IsOpen(TQ3FileObject theFile, TQ3Boolean *isOpen)
  336. ;
  337.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  338.         IMPORT_CFM_FUNCTION Q3File_IsOpen
  339.     ENDIF
  340.  
  341. ;
  342. ; extern TQ3Status Q3File_GetMode(TQ3FileObject theFile, TQ3FileMode *mode)
  343. ;
  344.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  345.         IMPORT_CFM_FUNCTION Q3File_GetMode
  346.     ENDIF
  347.  
  348. ;
  349. ; extern TQ3Status Q3File_GetVersion(TQ3FileObject theFile, TQ3FileVersion *version)
  350. ;
  351.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  352.         IMPORT_CFM_FUNCTION Q3File_GetVersion
  353.     ENDIF
  354.  
  355. ;
  356. ; extern TQ3Status Q3File_Close(TQ3FileObject theFile)
  357. ;
  358.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  359.         IMPORT_CFM_FUNCTION Q3File_Close
  360.     ENDIF
  361.  
  362. ;
  363. ; extern TQ3Status Q3File_Cancel(TQ3FileObject theFile)
  364. ;
  365.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  366.         IMPORT_CFM_FUNCTION Q3File_Cancel
  367.     ENDIF
  368.  
  369. ; 
  370. ; * Writing (Application)
  371. ; 
  372.  
  373. ;
  374. ; extern TQ3Status Q3View_StartWriting(TQ3ViewObject view, TQ3FileObject theFile)
  375. ;
  376.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  377.         IMPORT_CFM_FUNCTION Q3View_StartWriting
  378.     ENDIF
  379.  
  380. ;
  381. ; extern TQ3ViewStatus Q3View_EndWriting(TQ3ViewObject view)
  382. ;
  383.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  384.         IMPORT_CFM_FUNCTION Q3View_EndWriting
  385.     ENDIF
  386.  
  387. ; 
  388. ; * Reading (Application)
  389. ; 
  390.  
  391. ;
  392. ; extern TQ3ObjectType Q3File_GetNextObjectType(TQ3FileObject theFile)
  393. ;
  394.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  395.         IMPORT_CFM_FUNCTION Q3File_GetNextObjectType
  396.     ENDIF
  397.  
  398. ;
  399. ; extern TQ3Boolean Q3File_IsNextObjectOfType(TQ3FileObject theFile, TQ3ObjectType ofType)
  400. ;
  401.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  402.         IMPORT_CFM_FUNCTION Q3File_IsNextObjectOfType
  403.     ENDIF
  404.  
  405. ;
  406. ; extern TQ3Object Q3File_ReadObject(TQ3FileObject theFile)
  407. ;
  408.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  409.         IMPORT_CFM_FUNCTION Q3File_ReadObject
  410.     ENDIF
  411.  
  412. ;
  413. ; extern TQ3Status Q3File_SkipObject(TQ3FileObject theFile)
  414. ;
  415.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  416.         IMPORT_CFM_FUNCTION Q3File_SkipObject
  417.     ENDIF
  418.  
  419. ;
  420. ; extern TQ3Boolean Q3File_IsEndOfData(TQ3FileObject theFile)
  421. ;
  422.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  423.         IMPORT_CFM_FUNCTION Q3File_IsEndOfData
  424.     ENDIF
  425.  
  426. ;
  427. ; extern TQ3Boolean Q3File_IsEndOfContainer(TQ3FileObject theFile, TQ3Object rootObject)
  428. ;
  429.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  430.         IMPORT_CFM_FUNCTION Q3File_IsEndOfContainer
  431.     ENDIF
  432.  
  433. ;
  434. ; extern TQ3Boolean Q3File_IsEndOfFile(TQ3FileObject theFile)
  435. ;
  436.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  437.         IMPORT_CFM_FUNCTION Q3File_IsEndOfFile
  438.     ENDIF
  439.  
  440. ;     
  441. ; *  External file references
  442. ; 
  443.  
  444. ;
  445. ; extern TQ3Status Q3File_MarkAsExternalReference(TQ3FileObject theFile, TQ3SharedObject sharedObject)
  446. ;
  447.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  448.         IMPORT_CFM_FUNCTION Q3File_MarkAsExternalReference
  449.     ENDIF
  450.  
  451. ;
  452. ; extern TQ3GroupObject Q3File_GetExternalReferences(TQ3FileObject theFile)
  453. ;
  454.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  455.         IMPORT_CFM_FUNCTION Q3File_GetExternalReferences
  456.     ENDIF
  457.  
  458. ;     
  459. ; *  Tracking editing in read-in objects with custom elements
  460. ; 
  461.  
  462. ;
  463. ; extern TQ3Status Q3Shared_ClearEditTracking(TQ3SharedObject sharedObject)
  464. ;
  465.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  466.         IMPORT_CFM_FUNCTION Q3Shared_ClearEditTracking
  467.     ENDIF
  468.  
  469. ;
  470. ; extern TQ3Boolean Q3Shared_GetEditTrackingState(TQ3SharedObject sharedObject)
  471. ;
  472.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  473.         IMPORT_CFM_FUNCTION Q3Shared_GetEditTrackingState
  474.     ENDIF
  475.  
  476. ;     
  477. ; *  Reading objects inside a group one-by-one
  478. ; 
  479.  
  480.  
  481. ; typedef long                            TQ3FileReadGroupStateMasks
  482. kQ3FileReadWholeGroup            EQU        0
  483. kQ3FileReadObjectsInGroup        EQU        $01
  484. kQ3FileCurrentlyInsideGroup        EQU        $02
  485. ; typedef unsigned long                 TQ3FileReadGroupState
  486.  
  487. ;
  488. ; extern TQ3Status Q3File_SetReadInGroup(TQ3FileObject theFile, TQ3FileReadGroupState readGroupState)
  489. ;
  490.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  491.         IMPORT_CFM_FUNCTION Q3File_SetReadInGroup
  492.     ENDIF
  493.  
  494. ;
  495. ; extern TQ3Status Q3File_GetReadInGroup(TQ3FileObject theFile, TQ3FileReadGroupState *readGroupState)
  496. ;
  497.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  498.         IMPORT_CFM_FUNCTION Q3File_GetReadInGroup
  499.     ENDIF
  500.  
  501.  
  502. ; 
  503. ; * Idling
  504. ; 
  505.  
  506. ;
  507. ; extern TQ3Status Q3File_SetIdleMethod(TQ3FileObject theFile, TQ3FileIdleMethod idle, const void *idleData)
  508. ;
  509.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  510.         IMPORT_CFM_FUNCTION Q3File_SetIdleMethod
  511.     ENDIF
  512.  
  513.  
  514. ; ******************************************************************************
  515. ; **                                                                              **
  516. ; **                                Primitives Routines                             **
  517. ; **                                                                              **
  518. ; ****************************************************************************
  519.  
  520. ;
  521. ; extern TQ3Status Q3NewLine_Write(TQ3FileObject theFile)
  522. ;
  523.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  524.         IMPORT_CFM_FUNCTION Q3NewLine_Write
  525.     ENDIF
  526.  
  527. ;
  528. ; extern TQ3Status Q3Uns8_Read(TQ3Uns8 *data, TQ3FileObject theFile)
  529. ;
  530.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  531.         IMPORT_CFM_FUNCTION Q3Uns8_Read
  532.     ENDIF
  533.  
  534. ;
  535. ; extern TQ3Status Q3Uns8_Write(TQ3Uns8 data, TQ3FileObject theFile)
  536. ;
  537.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  538.         IMPORT_CFM_FUNCTION Q3Uns8_Write
  539.     ENDIF
  540.  
  541. ;
  542. ; extern TQ3Status Q3Uns16_Read(TQ3Uns16 *data, TQ3FileObject theFile)
  543. ;
  544.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  545.         IMPORT_CFM_FUNCTION Q3Uns16_Read
  546.     ENDIF
  547.  
  548. ;
  549. ; extern TQ3Status Q3Uns16_Write(TQ3Uns16 data, TQ3FileObject theFile)
  550. ;
  551.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  552.         IMPORT_CFM_FUNCTION Q3Uns16_Write
  553.     ENDIF
  554.  
  555. ;
  556. ; extern TQ3Status Q3Uns32_Read(TQ3Uns32 *data, TQ3FileObject theFile)
  557. ;
  558.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  559.         IMPORT_CFM_FUNCTION Q3Uns32_Read
  560.     ENDIF
  561.  
  562. ;
  563. ; extern TQ3Status Q3Uns32_Write(TQ3Uns32 data, TQ3FileObject theFile)
  564. ;
  565.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  566.         IMPORT_CFM_FUNCTION Q3Uns32_Write
  567.     ENDIF
  568.  
  569. ;
  570. ; extern TQ3Status Q3Int8_Read(TQ3Int8 *data, TQ3FileObject theFile)
  571. ;
  572.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  573.         IMPORT_CFM_FUNCTION Q3Int8_Read
  574.     ENDIF
  575.  
  576. ;
  577. ; extern TQ3Status Q3Int8_Write(TQ3Int8 data, TQ3FileObject theFile)
  578. ;
  579.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  580.         IMPORT_CFM_FUNCTION Q3Int8_Write
  581.     ENDIF
  582.  
  583. ;
  584. ; extern TQ3Status Q3Int16_Read(TQ3Int16 *data, TQ3FileObject theFile)
  585. ;
  586.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  587.         IMPORT_CFM_FUNCTION Q3Int16_Read
  588.     ENDIF
  589.  
  590. ;
  591. ; extern TQ3Status Q3Int16_Write(TQ3Int16 data, TQ3FileObject theFile)
  592. ;
  593.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  594.         IMPORT_CFM_FUNCTION Q3Int16_Write
  595.     ENDIF
  596.  
  597. ;
  598. ; extern TQ3Status Q3Int32_Read(TQ3Int32 *data, TQ3FileObject theFile)
  599. ;
  600.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  601.         IMPORT_CFM_FUNCTION Q3Int32_Read
  602.     ENDIF
  603.  
  604. ;
  605. ; extern TQ3Status Q3Int32_Write(TQ3Int32 data, TQ3FileObject theFile)
  606. ;
  607.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  608.         IMPORT_CFM_FUNCTION Q3Int32_Write
  609.     ENDIF
  610.  
  611. ;
  612. ; extern TQ3Status Q3Uns64_Read(TQ3Uns64 *data, TQ3FileObject theFile)
  613. ;
  614.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  615.         IMPORT_CFM_FUNCTION Q3Uns64_Read
  616.     ENDIF
  617.  
  618. ;
  619. ; extern TQ3Status Q3Uns64_Write(TQ3Uns64 data, TQ3FileObject theFile)
  620. ;
  621.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  622.         IMPORT_CFM_FUNCTION Q3Uns64_Write
  623.     ENDIF
  624.  
  625. ;
  626. ; extern TQ3Status Q3Int64_Read(TQ3Int64 *data, TQ3FileObject theFile)
  627. ;
  628.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  629.         IMPORT_CFM_FUNCTION Q3Int64_Read
  630.     ENDIF
  631.  
  632. ;
  633. ; extern TQ3Status Q3Int64_Write(TQ3Int64 data, TQ3FileObject theFile)
  634. ;
  635.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  636.         IMPORT_CFM_FUNCTION Q3Int64_Write
  637.     ENDIF
  638.  
  639. ;
  640. ; extern TQ3Status Q3Float32_Read(TQ3Float32 *data, TQ3FileObject theFile)
  641. ;
  642.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  643.         IMPORT_CFM_FUNCTION Q3Float32_Read
  644.     ENDIF
  645.  
  646. ;
  647. ; extern TQ3Status Q3Float32_Write(TQ3Float32 data, TQ3FileObject theFile)
  648. ;
  649.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  650.         IMPORT_CFM_FUNCTION Q3Float32_Write
  651.     ENDIF
  652.  
  653. ;
  654. ; extern TQ3Status Q3Float64_Read(TQ3Float64 *data, TQ3FileObject theFile)
  655. ;
  656.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  657.         IMPORT_CFM_FUNCTION Q3Float64_Read
  658.     ENDIF
  659.  
  660. ;
  661. ; extern TQ3Status Q3Float64_Write(TQ3Float64 data, TQ3FileObject theFile)
  662. ;
  663.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  664.         IMPORT_CFM_FUNCTION Q3Float64_Write
  665.     ENDIF
  666.  
  667. ;
  668. ; extern TQ3Size Q3Size_Pad(TQ3Size size)
  669. ;
  670.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  671.         IMPORT_CFM_FUNCTION Q3Size_Pad
  672.     ENDIF
  673.  
  674. ; 
  675. ; * Pass a pointer to a buffer of kQ3StringMaximumLength bytes
  676. ; 
  677.  
  678. ;
  679. ; extern TQ3Status Q3String_Read(char *data, unsigned long *length, TQ3FileObject theFile)
  680. ;
  681.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  682.         IMPORT_CFM_FUNCTION Q3String_Read
  683.     ENDIF
  684.  
  685. ;
  686. ; extern TQ3Status Q3String_Write(const char *data, TQ3FileObject theFile)
  687. ;
  688.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  689.         IMPORT_CFM_FUNCTION Q3String_Write
  690.     ENDIF
  691.  
  692. ;  
  693. ; * This call will read Q3Size_Pad(size) bytes,
  694. ; *    but only place size bytes into data.
  695. ; 
  696.  
  697. ;
  698. ; extern TQ3Status Q3RawData_Read(unsigned char *data, unsigned long size, TQ3FileObject theFile)
  699. ;
  700.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  701.         IMPORT_CFM_FUNCTION Q3RawData_Read
  702.     ENDIF
  703.  
  704. ;  
  705. ; * This call will write Q3Size_Pad(size) bytes,
  706. ; *    adding 0's to pad to the nearest 4 byte boundary.
  707. ; 
  708.  
  709. ;
  710. ; extern TQ3Status Q3RawData_Write(const unsigned char *data, unsigned long size, TQ3FileObject theFile)
  711. ;
  712.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  713.         IMPORT_CFM_FUNCTION Q3RawData_Write
  714.     ENDIF
  715.  
  716. ; ******************************************************************************
  717. ; **                                                                              **
  718. ; **                        Convenient Primitives Routines                         **
  719. ; **                                                                              **
  720. ; ****************************************************************************
  721.  
  722. ;
  723. ; extern TQ3Status Q3Point2D_Read(TQ3Point2D *point2D, TQ3FileObject theFile)
  724. ;
  725.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  726.         IMPORT_CFM_FUNCTION Q3Point2D_Read
  727.     ENDIF
  728.  
  729. ;
  730. ; extern TQ3Status Q3Point2D_Write(const TQ3Point2D *point2D, TQ3FileObject theFile)
  731. ;
  732.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  733.         IMPORT_CFM_FUNCTION Q3Point2D_Write
  734.     ENDIF
  735.  
  736. ;
  737. ; extern TQ3Status Q3Point3D_Read(TQ3Point3D *point3D, TQ3FileObject theFile)
  738. ;
  739.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  740.         IMPORT_CFM_FUNCTION Q3Point3D_Read
  741.     ENDIF
  742.  
  743. ;
  744. ; extern TQ3Status Q3Point3D_Write(const TQ3Point3D *point3D, TQ3FileObject theFile)
  745. ;
  746.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  747.         IMPORT_CFM_FUNCTION Q3Point3D_Write
  748.     ENDIF
  749.  
  750. ;
  751. ; extern TQ3Status Q3RationalPoint3D_Read(TQ3RationalPoint3D *point3D, TQ3FileObject theFile)
  752. ;
  753.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  754.         IMPORT_CFM_FUNCTION Q3RationalPoint3D_Read
  755.     ENDIF
  756.  
  757. ;
  758. ; extern TQ3Status Q3RationalPoint3D_Write(const TQ3RationalPoint3D *point3D, TQ3FileObject theFile)
  759. ;
  760.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  761.         IMPORT_CFM_FUNCTION Q3RationalPoint3D_Write
  762.     ENDIF
  763.  
  764. ;
  765. ; extern TQ3Status Q3RationalPoint4D_Read(TQ3RationalPoint4D *point4D, TQ3FileObject theFile)
  766. ;
  767.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  768.         IMPORT_CFM_FUNCTION Q3RationalPoint4D_Read
  769.     ENDIF
  770.  
  771. ;
  772. ; extern TQ3Status Q3RationalPoint4D_Write(const TQ3RationalPoint4D *point4D, TQ3FileObject theFile)
  773. ;
  774.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  775.         IMPORT_CFM_FUNCTION Q3RationalPoint4D_Write
  776.     ENDIF
  777.  
  778. ;
  779. ; extern TQ3Status Q3Vector2D_Read(TQ3Vector2D *vector2D, TQ3FileObject theFile)
  780. ;
  781.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  782.         IMPORT_CFM_FUNCTION Q3Vector2D_Read
  783.     ENDIF
  784.  
  785. ;
  786. ; extern TQ3Status Q3Vector2D_Write(const TQ3Vector2D *vector2D, TQ3FileObject theFile)
  787. ;
  788.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  789.         IMPORT_CFM_FUNCTION Q3Vector2D_Write
  790.     ENDIF
  791.  
  792. ;
  793. ; extern TQ3Status Q3Vector3D_Read(TQ3Vector3D *vector3D, TQ3FileObject theFile)
  794. ;
  795.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  796.         IMPORT_CFM_FUNCTION Q3Vector3D_Read
  797.     ENDIF
  798.  
  799. ;
  800. ; extern TQ3Status Q3Vector3D_Write(const TQ3Vector3D *vector3D, TQ3FileObject theFile)
  801. ;
  802.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  803.         IMPORT_CFM_FUNCTION Q3Vector3D_Write
  804.     ENDIF
  805.  
  806. ;
  807. ; extern TQ3Status Q3Matrix4x4_Read(TQ3Matrix4x4 *matrix4x4, TQ3FileObject theFile)
  808. ;
  809.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  810.         IMPORT_CFM_FUNCTION Q3Matrix4x4_Read
  811.     ENDIF
  812.  
  813. ;
  814. ; extern TQ3Status Q3Matrix4x4_Write(const TQ3Matrix4x4 *matrix4x4, TQ3FileObject theFile)
  815. ;
  816.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  817.         IMPORT_CFM_FUNCTION Q3Matrix4x4_Write
  818.     ENDIF
  819.  
  820. ;
  821. ; extern TQ3Status Q3Tangent2D_Read(TQ3Tangent2D *tangent2D, TQ3FileObject theFile)
  822. ;
  823.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  824.         IMPORT_CFM_FUNCTION Q3Tangent2D_Read
  825.     ENDIF
  826.  
  827. ;
  828. ; extern TQ3Status Q3Tangent2D_Write(const TQ3Tangent2D *tangent2D, TQ3FileObject theFile)
  829. ;
  830.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  831.         IMPORT_CFM_FUNCTION Q3Tangent2D_Write
  832.     ENDIF
  833.  
  834. ;
  835. ; extern TQ3Status Q3Tangent3D_Read(TQ3Tangent3D *tangent3D, TQ3FileObject theFile)
  836. ;
  837.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  838.         IMPORT_CFM_FUNCTION Q3Tangent3D_Read
  839.     ENDIF
  840.  
  841. ;
  842. ; extern TQ3Status Q3Tangent3D_Write(const TQ3Tangent3D *tangent3D, TQ3FileObject theFile)
  843. ;
  844.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  845.         IMPORT_CFM_FUNCTION Q3Tangent3D_Write
  846.     ENDIF
  847.  
  848. ;     This call affects only text Files - it is a no-op in binary files 
  849. ;
  850. ; extern TQ3Status Q3Comment_Write(char *comment, TQ3FileObject theFile)
  851. ;
  852.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  853.         IMPORT_CFM_FUNCTION Q3Comment_Write
  854.     ENDIF
  855.  
  856. ; ******************************************************************************
  857. ; **                                                                              **
  858. ; **                                Unknown Object                                 **
  859. ; **                                                                              **
  860. ; **        Unknown objects are generated when reading files which contain         **
  861. ; **        custom data which has not been registered in the current             **
  862. ; **        instantiation of QuickDraw 3D.                                         **
  863. ; **                                                                              **
  864. ; ****************************************************************************
  865.  
  866. ;
  867. ; extern TQ3ObjectType Q3Unknown_GetType(TQ3UnknownObject unknownObject)
  868. ;
  869.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  870.         IMPORT_CFM_FUNCTION Q3Unknown_GetType
  871.     ENDIF
  872.  
  873. ;
  874. ; extern TQ3Status Q3Unknown_GetDirtyState(TQ3UnknownObject unknownObject, TQ3Boolean *isDirty)
  875. ;
  876.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  877.         IMPORT_CFM_FUNCTION Q3Unknown_GetDirtyState
  878.     ENDIF
  879.  
  880. ;
  881. ; extern TQ3Status Q3Unknown_SetDirtyState(TQ3UnknownObject unknownObject, TQ3Boolean isDirty)
  882. ;
  883.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  884.         IMPORT_CFM_FUNCTION Q3Unknown_SetDirtyState
  885.     ENDIF
  886.  
  887.  
  888. ; ******************************************************************************
  889. ; **                                                                              **
  890. ; **                            Unknown Text Routines                             **
  891. ; **                                                                              **
  892. ; ****************************************************************************
  893.  
  894. TQ3UnknownTextData        RECORD 0
  895. objectName                 ds.l    1                ; offset: $0 (0)        ;  '\0' terminated 
  896. contents                 ds.l    1                ; offset: $4 (4)        ;  '\0' terminated 
  897. sizeof                     EQU *                    ; size:   $8 (8)
  898.                         ENDR
  899. ;
  900. ; extern TQ3Status Q3UnknownText_GetData(TQ3UnknownObject unknownObject, TQ3UnknownTextData *unknownTextData)
  901. ;
  902.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  903.         IMPORT_CFM_FUNCTION Q3UnknownText_GetData
  904.     ENDIF
  905.  
  906. ;
  907. ; extern TQ3Status Q3UnknownText_EmptyData(TQ3UnknownTextData *unknownTextData)
  908. ;
  909.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  910.         IMPORT_CFM_FUNCTION Q3UnknownText_EmptyData
  911.     ENDIF
  912.  
  913.  
  914. ; ******************************************************************************
  915. ; **                                                                              **
  916. ; **                            Unknown Binary Routines                             **
  917. ; **                                                                              **
  918. ; ****************************************************************************
  919.  
  920. TQ3UnknownBinaryData    RECORD 0
  921. objectType                 ds.l    1                ; offset: $0 (0)
  922. size                     ds.l    1                ; offset: $4 (4)
  923. byteOrder                 ds.l    1                ; offset: $8 (8)
  924. contents                 ds.l    1                ; offset: $C (12)
  925. sizeof                     EQU *                    ; size:   $10 (16)
  926.                         ENDR
  927. ;
  928. ; extern TQ3Status Q3UnknownBinary_GetData(TQ3UnknownObject unknownObject, TQ3UnknownBinaryData *unknownBinaryData)
  929. ;
  930.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  931.         IMPORT_CFM_FUNCTION Q3UnknownBinary_GetData
  932.     ENDIF
  933.  
  934. ;
  935. ; extern TQ3Status Q3UnknownBinary_EmptyData(TQ3UnknownBinaryData *unknownBinaryData)
  936. ;
  937.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  938.         IMPORT_CFM_FUNCTION Q3UnknownBinary_EmptyData
  939.     ENDIF
  940.  
  941.  
  942. ;
  943. ; extern TQ3Status Q3UnknownBinary_GetTypeString(TQ3UnknownObject unknownObject, char **typeString)
  944. ;
  945.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  946.         IMPORT_CFM_FUNCTION Q3UnknownBinary_GetTypeString
  947.     ENDIF
  948.  
  949. ;
  950. ; extern TQ3Status Q3UnknownBinary_EmptyTypeString(char **typeString)
  951. ;
  952.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  953.         IMPORT_CFM_FUNCTION Q3UnknownBinary_EmptyTypeString
  954.     ENDIF
  955.  
  956. ; ******************************************************************************
  957. ; **                                                                              **
  958. ; **                            ViewHints routines                                 **
  959. ; **                                                                              **
  960. ; **        ViewHints are an object in a metafile to give you some hints on how     **
  961. ; **        to render a scene.    You may create a view with any of the objects     **
  962. ; **        retrieved from it, or you can just throw it away.                     **
  963. ; **                                                                              **
  964. ; **        To write a view hints to a file, create a view hints object from a     **
  965. ; **        view and write the view hints.                                         **
  966. ; **                                                                              **
  967. ; ****************************************************************************
  968.  
  969. ;
  970. ; extern TQ3ViewHintsObject Q3ViewHints_New(TQ3ViewObject view)
  971. ;
  972.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  973.         IMPORT_CFM_FUNCTION Q3ViewHints_New
  974.     ENDIF
  975.  
  976. ;
  977. ; extern TQ3Status Q3ViewHints_SetRenderer(TQ3ViewHintsObject viewHints, TQ3RendererObject renderer)
  978. ;
  979.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  980.         IMPORT_CFM_FUNCTION Q3ViewHints_SetRenderer
  981.     ENDIF
  982.  
  983. ;
  984. ; extern TQ3Status Q3ViewHints_GetRenderer(TQ3ViewHintsObject viewHints, TQ3RendererObject *renderer)
  985. ;
  986.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  987.         IMPORT_CFM_FUNCTION Q3ViewHints_GetRenderer
  988.     ENDIF
  989.  
  990. ;
  991. ; extern TQ3Status Q3ViewHints_SetCamera(TQ3ViewHintsObject viewHints, TQ3CameraObject camera)
  992. ;
  993.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  994.         IMPORT_CFM_FUNCTION Q3ViewHints_SetCamera
  995.     ENDIF
  996.  
  997. ;
  998. ; extern TQ3Status Q3ViewHints_GetCamera(TQ3ViewHintsObject viewHints, TQ3CameraObject *camera)
  999. ;
  1000.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1001.         IMPORT_CFM_FUNCTION Q3ViewHints_GetCamera
  1002.     ENDIF
  1003.  
  1004. ;
  1005. ; extern TQ3Status Q3ViewHints_SetLightGroup(TQ3ViewHintsObject viewHints, TQ3GroupObject lightGroup)
  1006. ;
  1007.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1008.         IMPORT_CFM_FUNCTION Q3ViewHints_SetLightGroup
  1009.     ENDIF
  1010.  
  1011. ;
  1012. ; extern TQ3Status Q3ViewHints_GetLightGroup(TQ3ViewHintsObject viewHints, TQ3GroupObject *lightGroup)
  1013. ;
  1014.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1015.         IMPORT_CFM_FUNCTION Q3ViewHints_GetLightGroup
  1016.     ENDIF
  1017.  
  1018. ;
  1019. ; extern TQ3Status Q3ViewHints_SetAttributeSet(TQ3ViewHintsObject viewHints, TQ3AttributeSet attributeSet)
  1020. ;
  1021.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1022.         IMPORT_CFM_FUNCTION Q3ViewHints_SetAttributeSet
  1023.     ENDIF
  1024.  
  1025. ;
  1026. ; extern TQ3Status Q3ViewHints_GetAttributeSet(TQ3ViewHintsObject viewHints, TQ3AttributeSet *attributeSet)
  1027. ;
  1028.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1029.         IMPORT_CFM_FUNCTION Q3ViewHints_GetAttributeSet
  1030.     ENDIF
  1031.  
  1032. ;
  1033. ; extern TQ3Status Q3ViewHints_SetDimensionsState(TQ3ViewHintsObject viewHints, TQ3Boolean isValid)
  1034. ;
  1035.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1036.         IMPORT_CFM_FUNCTION Q3ViewHints_SetDimensionsState
  1037.     ENDIF
  1038.  
  1039. ;
  1040. ; extern TQ3Status Q3ViewHints_GetDimensionsState(TQ3ViewHintsObject viewHints, TQ3Boolean *isValid)
  1041. ;
  1042.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1043.         IMPORT_CFM_FUNCTION Q3ViewHints_GetDimensionsState
  1044.     ENDIF
  1045.  
  1046. ;
  1047. ; extern TQ3Status Q3ViewHints_SetDimensions(TQ3ViewHintsObject viewHints, unsigned long width, unsigned long height)
  1048. ;
  1049.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1050.         IMPORT_CFM_FUNCTION Q3ViewHints_SetDimensions
  1051.     ENDIF
  1052.  
  1053. ;
  1054. ; extern TQ3Status Q3ViewHints_GetDimensions(TQ3ViewHintsObject viewHints, unsigned long *width, unsigned long *height)
  1055. ;
  1056.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1057.         IMPORT_CFM_FUNCTION Q3ViewHints_GetDimensions
  1058.     ENDIF
  1059.  
  1060. ;
  1061. ; extern TQ3Status Q3ViewHints_SetMaskState(TQ3ViewHintsObject viewHints, TQ3Boolean isValid)
  1062. ;
  1063.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1064.         IMPORT_CFM_FUNCTION Q3ViewHints_SetMaskState
  1065.     ENDIF
  1066.  
  1067. ;
  1068. ; extern TQ3Status Q3ViewHints_GetMaskState(TQ3ViewHintsObject viewHints, TQ3Boolean *isValid)
  1069. ;
  1070.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1071.         IMPORT_CFM_FUNCTION Q3ViewHints_GetMaskState
  1072.     ENDIF
  1073.  
  1074. ;
  1075. ; extern TQ3Status Q3ViewHints_SetMask(TQ3ViewHintsObject viewHints, const TQ3Bitmap *mask)
  1076. ;
  1077.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1078.         IMPORT_CFM_FUNCTION Q3ViewHints_SetMask
  1079.     ENDIF
  1080.  
  1081. ;
  1082. ; extern TQ3Status Q3ViewHints_GetMask(TQ3ViewHintsObject viewHints, TQ3Bitmap *mask)
  1083. ;
  1084.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1085.         IMPORT_CFM_FUNCTION Q3ViewHints_GetMask
  1086.     ENDIF
  1087.  
  1088. ;  Call Q3Bitmap_Empty when done with the mask    
  1089. ;
  1090. ; extern TQ3Status Q3ViewHints_SetClearImageMethod(TQ3ViewHintsObject viewHints, TQ3DrawContextClearImageMethod clearMethod)
  1091. ;
  1092.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1093.         IMPORT_CFM_FUNCTION Q3ViewHints_SetClearImageMethod
  1094.     ENDIF
  1095.  
  1096. ;
  1097. ; extern TQ3Status Q3ViewHints_GetClearImageMethod(TQ3ViewHintsObject viewHints, TQ3DrawContextClearImageMethod *clearMethod)
  1098. ;
  1099.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1100.         IMPORT_CFM_FUNCTION Q3ViewHints_GetClearImageMethod
  1101.     ENDIF
  1102.  
  1103. ;
  1104. ; extern TQ3Status Q3ViewHints_SetClearImageColor(TQ3ViewHintsObject viewHints, const TQ3ColorARGB *color)
  1105. ;
  1106.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1107.         IMPORT_CFM_FUNCTION Q3ViewHints_SetClearImageColor
  1108.     ENDIF
  1109.  
  1110. ;
  1111. ; extern TQ3Status Q3ViewHints_GetClearImageColor(TQ3ViewHintsObject viewHints, TQ3ColorARGB *color)
  1112. ;
  1113.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1114.         IMPORT_CFM_FUNCTION Q3ViewHints_GetClearImageColor
  1115.     ENDIF
  1116.  
  1117.  
  1118.  
  1119.     ENDIF ; __QD3DIO__ 
  1120.  
  1121.